From f58baf1391d95691cbd92b290e5154907666fe4c Mon Sep 17 00:00:00 2001
From: Matthias Clasen <matthiasc@src.gnome.org>
Date: Thu, 29 May 2008 04:19:54 +0000
Subject: [PATCH] Additions

svn path=/trunk/; revision=20228
---
 docs/reference/ChangeLog          |  4 ++++
 docs/reference/gtk/compiling.sgml | 10 ++++++++++
 2 files changed, 14 insertions(+)

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 5ccb04cd0c..f6dd8293b6 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,7 @@
+2008-05-28  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/compiling.sgml: Explains single includes
+
 2008-05-28  Matthias Clasen  <mclasen@redhat.com>
 
 	Bug 535250 - GtkToolButton reference page says "label" where 
diff --git a/docs/reference/gtk/compiling.sgml b/docs/reference/gtk/compiling.sgml
index d5b89dea85..b523372376 100644
--- a/docs/reference/gtk/compiling.sgml
+++ b/docs/reference/gtk/compiling.sgml
@@ -58,6 +58,16 @@ symbol GDK_MULTIHEAD_SAFE by using the command line option
 <literal>-DGTK_MULTIHEAD_SAFE=1</literal>.
 </para>
 
+<para>
+The recommended way of using GTK+ has always been to only include the
+toplevel headers <filename>gtk.h</filename>, <filename>gdk.h</filename>, 
+<filename>gdk-pixbuf.h</filename>.
+If you want to make sure that your program follows this recommended
+practise, you can define the preprocessor symbols GTK_DISABLE_SINGLE_INCLUDES
+and GDK_PIXBUF_DISABLE_SINGLE_INCLUDES to make GTK+ generate an error
+when individual headers are directly included. 
+</para>
+
 </refsect1>
 </refentry>
 
-- 
2.30.2